<!doctype HTML public "-//W3C//DTD HTML 4.0 Frameset//EN">
<html>
<head>
<meta http-equiv="content-type" content="text/html; charset=utf-8">
<meta name="generator" content="Adobe RoboHelp - www.adobe.com">
<title>Hierarchy prompt</title>
<link rel="stylesheet" href="userhelp_ns.css"><script type="text/javascript" language="JavaScript" title="WebHelpSplitCss">
<!--
if (navigator.appName !="Netscape")
{   document.write("<link rel='stylesheet' href='userhelp.css'>");}
//-->
</script>
<style type="text/css">
<!--
ul.whs1 { list-style:disc; }
ol.whs2 { list-style:decimal; }
p.whs3 { font-weight:bold; margin-left:24px; }
p.whs4 { margin-left:24px; }
p.whs5 { margin-left:0px; }
p.whs6 { margin-left:0px; font-weight:bold; }
-->
</style><script type="text/javascript" language="JavaScript">
<!--
if ((navigator.appName == "Netscape") && (parseInt(navigator.appVersion) == 4))
{
  var strNSS = "<style type='text/css'>";
  strNSS += "p.whs5 {margin-left:1pt; }";
  strNSS += "p.whs6 {margin-left:1pt; }";
  strNSS +="</style>";
  document.write(strNSS);
}
//-->
</script>
<script type="text/javascript" language="JavaScript" title="WebHelpInlineScript">
<!--
function reDo() {
  if (innerWidth != origWidth || innerHeight != origHeight)
     location.reload();
}
if ((parseInt(navigator.appVersion) == 4) && (navigator.appName == "Netscape")) {
	origWidth = innerWidth;
	origHeight = innerHeight;
	onresize = reDo;
}
onerror = null; 
//-->
</script>
<style type="text/css">
<!--
div.WebHelpPopupMenu { position:absolute; left:0px; top:0px; z-index:4; visibility:hidden; }
-->
</style><script type="text/javascript" language="javascript1.2" src="whmsg.js"></script>
<script type="text/javascript" language="javascript" src="whver.js"></script>
<script type="text/javascript" language="javascript1.2" src="whproxy.js"></script>
<script type="text/javascript" language="javascript1.2" src="whutils.js"></script>
<script type="text/javascript" language="javascript1.2" src="whlang.js"></script>
<script type="text/javascript" language="javascript1.2" src="whtopic.js"></script>
</head>
<body><script type="text/javascript" language="javascript1.2">
<!--
if (window.gbWhTopic)
{
	if (window.addTocInfo)
	{
	addTocInfo("Creating and modifying reports\nAsking for user input: Prompts\nCreating a prompt\nHierarchy qualification prompt");
addButton("show",BTN_TEXT,"Show","","","","",0,0,"","","");

	}
	if (window.writeBtnStyle)
		writeBtnStyle();

	if (window.writeIntopicBar)
		writeIntopicBar(1);

	if(1)
	{
	
	}

	if (window.setRelStartPage)
	{
	setRelStartPage("MicroStrategy_Web_Help.htm");

		autoSync(1);
		sendSyncInfo();
		sendAveInfoOut();
	}
}
else
	if (window.gbIE4)
		document.location.reload();

//-->
</script>
<h1>Hierarchy Qualification Prompt</h1>
<p>The Hierarchy Qualification Prompt allows users to create their own 
 report filter using attributes and attribute elements from:</p>
<ul type="disc" class="whs1">
	
<li class=p><p>A specific hierarchy</p></li>
	
<li class=p><p>All hierarchies in the project</p></li>
	
<li class=p><p>Specific hierarchies returned by a search object</p></li>
</ul>
<p>For an explanation of what a hierarchy is, see the <span style="font-style: italic;"><I>Answering 
 Questions about Data</I></span> chapter in the <span style="font-style: italic;"><I>Basic 
 Reporting Guide</I></span>. This book also contains examples and images for 
 a Hierarchy Qualification Prompt.</p>
<p>Of the three filter definition prompts for attributes, the Hierarchy 
 Qualification Prompt allows users to select from the widest number of 
 attribute elements when they are choosing prompt answers to define their 
 filtering criteria. The 
<a HREF="Attribute_qualification_prompts.htm">Attribute 
 prompt</a> is more restrictive, allowing users to choose from the fewest 
 number of attribute elements to define their filter criteria.</p>
<h2>Prerequisites</h2>
<ul type="disc" class="whs1">
	
<li class=p><p>DHTML must be enabled. See 
<a href="DHTML-only_features_in_Web.htm">Enabling 
 DHTML in MicroStrategy Web</a>.</p></li>
	
<li class=p><p>If you want analysts to answer a prompt by selecting 
 from the results of a search object, a search object must already be created.</p></li>
</ul>
<h2>To create a Hierarchy Qualification prompt</h2>
<ol type="1" class="whs2">
	
<li class=p><p>On the MicroStrategy Web home page, click <span style="font-weight: bold;"><B>Create 
 Prompt</B></span>. The Create Prompt page opens. </p></li>
	
<li class=p><p>Click <span style="font-weight: bold;"><B>Hierarchy Qualification 
 Prompt</B></span><span>. </span></p></li>
</ol>
<p class="whs3">To select the hierarchy</p>
<p class="whs4">Select the hierarchy which contains the attributes 
 that the user is prompted to choose from as they create the filter for 
 the report.</p>
<ol start="3" type="1" class="whs2">
	
<li class=p><p class="whs5">On the Definition tab, choose 
 one of the following options and, as necessary, specify the required information 
 for your chosen option:</p></li>
	<ul>
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>All hierarchies</B></span>: Select this option 
 to let the user choose attributes from all the hierarchies in the project.</p></li>
		
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>Choose a hierarchy</B></span>: Select this option 
 to present the user with a specific hierarchy from which to choose attributes 
 and elements. Browse to and select the hierarchy.</p></li>
	</ul>
	<ul>
<li style="list-style: disc;" type=disc class=p><p class="whs6">Use 
 a predefined list of hierarchies<span style="font-weight: normal;">: Select 
 this option to create a list of hierarchies from which users can choose. 
 Click </span>Add<span style="font-weight: normal;">, select the hierarchies, 
 then click </span>OK<span style="font-weight: normal;">. To remove an 
 object, highlight it and click </span>Remove<span style="font-weight: normal;">. 
 To remove all items, click </span>Clear<span style="font-weight: normal;">.</span></p></li>
		
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>Use the result of a search object</B></span>: Select 
 this option to browse to and select a previously created search object 
 or specify the name of the search object. A search object searches for 
 and displays specific project objects when the user executes the report. 
 This lets you prompt the user with the most up-to-date objects in the 
 project. </p></li>
	</ul>
</ol>
<p class="whs3">To determine the attribute 
 forms that are displayed to the user</p>
<p class="whs4">Once users select a hierarchy, the prompt 
 displays the related attributes and attribute elements they can select 
 their filter criteria from. The attribute forms can also be displayed. 
 For more information about attribute forms, see 
<a HREF="Display_attribute_forms.htm">Displaying 
 attribute forms</a>.</p>
<ol start="4" type="1" class="whs2">
	
<li class=p><p class="whs5">On the <span style="font-weight: bold;"><B>General</B></span> 
 tab, type a title and description for the prompt in the <span style="font-weight: bold;"><B>Title</B></span> 
 and <span style="font-weight: bold;"><B>Description</B></span> fields. <span 
 style="font-weight: bold;"><B><br>

	<br>

	To restrict the number of prompt answers.</B></span></p></li>
	
<li class=p><p class="whs5"><span style="margin-left: 0px;">To 
 require users to answer the prompt before running the report, specify 
 whether the prompt requires an answer. Select the </span><span style="margin-left: 0px; font-weight: bold;"><B>Prompt 
 answer is required</B></span><span style="margin-left: 0px;"> check box. If 
 you require an answer, it is a good idea to also provide a default answer, 
 otherwise a subscription to this report will fail.</span></p></li>
	
<li class=p><p class="whs5">Set the maximum and/or minimum 
 number of prompt answers allowed, if desired. Enter these numbers in the 
 <span style="font-weight: bold;"><B>Minimum number of answers </B></span>and<span 
 style="font-weight: bold;"><B> Maximum number of answers</B></span> fields.</p></li>
	
<li class=p><p class="whs5">Determine whether users can 
 save and reuse their prompt answers, and if so, how many prompt answers 
 they can save for the prompt. From the <span style="font-weight: bold;"><B>Personal 
 answers allowed </B></span>drop-down list, select one of the following: </p></li>
	
<li class=p><p class="whs5">On the <span style="font-weight: bold;"><B>Style</B></span> 
 tab, from the <span style="font-weight: bold;"><B>Display style</B></span> drop-down 
 list, specify a presentation style, such as Tree or Shopping Cart, for 
 the prompt. This is how the prompt is displayed to the user. </p></li>
	<ul>
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>None</B></span><span>:</span><span style="font-weight: bold;"> 
 <B></B></span>This setting does not allow you to save and reuse prompt answers.</p></li>
		
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>Single</B></span>: This setting allows you to save 
 and reuse only one prompt answer.</p></li>
		
<li style="list-style: disc;" type=disc class=p><p class="whs5"><span 
 style="font-weight: bold;"><B>Multiple</B></span>: This setting allows you to 
 save multiple personal prompt answers.<span style="font-weight: bold;"><B><br>

		<br>

		To specify the layout and display style of the prompt</B></span></p></li>
	</ul>
	
<li class=p><p class="whs5">To ensure that the prompt's 
 text fields and options are a fixed size, select the <span style="font-weight: bold;"><B>Fixed 
 text box width </B></span>and/or <span style="font-weight: bold;"><B>Fixed textbox 
 height</B></span> check boxes, and specify the size of the prompt's text fields 
 and options in the fields.</p></li>
	
<li class=p><p class="whs5">To determine how prompt options 
 are arranged, from the <span style="font-weight: bold;"><B>Orientation</B></span> 
 drop-down list, select <span style="font-weight: bold;"><B>Vertical</B></span> 
 or <span style="font-weight: bold;"><B>Horizontal</B></span>.</p></li>
	
<li class=p><p class="whs5">To determine the number of 
 prompt answers displayed in a row or column (depending on alignment), 
 enter a number in the <span style="font-weight: bold;"><B>Items per column/row</B></span> 
 field.</p></li>
	
<li class=p><p class="whs5">To allow users to use a search 
 box to locate prompt answers, select the <span style="font-weight: bold;"><B>Show 
 search box</B></span> check box. Searching for objects allows analysts to 
 quickly locate specific objects to use to answer the prompt.</p></li>
	<ul type="disc" class="whs1">
		
<li class=p><p>To ensure that users use the search box to locate 
 answers, select the <span style="font-weight: bold;"><B>Make search required</B></span> 
 check box.</p></li>
	</ul>
	
<li class=p><p class="whs5">If you are using the Shopping 
 Cart display style, you can select the <span style="font-weight: bold;"><B>Use 
 folder structure </B></span>check box to display the prompt choices in a folder 
 structure. This option, available for search objects only, is useful when 
 the same object with the same name is saved in multiple folders. </p></li>
	<ul>
<li style="list-style: disc;" type=disc class=p><p>To allow users 
 to navigate above the root folder when searching, select the <span style="font-weight: bold;"><B>Allow 
 navigation above search root</B></span> check box. </p></li>
	</ul>
</ol>
<p class="whs3"><span style="font-weight: bold;"><B>To 
 specify how qualifications are displayed in the prompt</B></span></p>
<ol start="16" type="1" class="whs2">
	
<li class=p><p>On the <span style="font-weight: bold;"><B>Qualification 
 </B></span>tab, determine the types of qualification expressions allowed in 
 the prompt by selecting an option from the <span style="font-weight: bold;"><B>Expression 
 type allowed</B></span> drop-down list.</p></li>
	
<li class=p><p>Determine the default condition (for example, Select 
 or Qualify) that is displayed in the prompt by selecting an option from 
 the <span style="font-weight: bold;"><B>Default</B></span> <span style="font-weight: bold;"><B>expression 
 type </B></span>drop-down list.</p></li>
	
<li class=p><p>Determine the default qualification operator (for example, 
 Greater than or Less than) that is displayed in the prompt by selecting 
 an option from the <span style="font-weight: bold;"><B>Default</B></span> <span 
 style="font-weight: bold;"><B>condition operator </B></span>drop-down list.</p></li>
	
<li class=p><p>Determine how many elements are listed in each prompt 
 answer list in the <span style="font-weight: bold;"><B>Maximum number of 
 elements per list</B></span> field.</p></li>
	
<li class=p><p>To allow users to import a list of attribute elements 
 from which they can choose, select the <span style="font-weight: bold;"><B>Allow 
 element import</B></span> check box.</p></li>
	
<li class=p><p>Determine the default logical operator that is used 
 between conditions by selecting an option from the <span style="font-weight: bold;"><B>Default 
 operator between conditions </B></span>drop-down list.</p></li>
	
<li class=p><p>To allow users to modify expressions, select the <span 
 style="font-weight: bold;"><B>Allow modification of the logical operator 
 </B></span>check box.</p></li>
	<ul>
<li style="list-style: disc;" type=disc class=p><p>To ensure that 
 users can only use a single condition operator (AND/OR) between all of 
 the conditions in an expression, select the<span style="font-weight: bold;"><B> 
 Use a single logical operator between all conditions </B></span>option.</p></li>
		
<li style="list-style: disc;" type=disc class=p><p>To ensure that 
 users can choose a default operator to use between each condition, select 
 the <span style="font-weight: bold;"><B>Allow the user to set independent 
 logical operators between conditions </B></span>option.</p></li>
	</ul>
</ol>
<p class="whs3"><span><B><span style="font-weight: bold;"><B>To 
 save the prompt</B></span></B></span></p>
<ol start="24" type="1" class="whs2">
	
<li class=p><p>To save the prompt, select <span style="font-weight: bold;"><B>Save 
 As</B></span>. The Save As dialog box opens.</p></li>
	
<li class=p><p>Specify a name, description, and the location in which 
 to save the prompt and click <span style="font-weight: bold;"><B>OK</B></span>.</p></li>
</ol>
<p class="whs5">You can now add your new prompt to a report. 
 See 
<a HREF="Add_prompts_to_reports.htm">Adding a prompt to a report</a>.</p>
<script type="text/javascript" language="javascript1.2">
<!--
highlightSearch();
if (window.writeIntopicBar)
	writeIntopicBar(0);
if(0)
{

}
//-->
</script>
</body>
</html>
